home *** CD-ROM | disk | FTP | other *** search
/ Just Call Me Internet / Just Call Me Internet.iso / com / othernet / fidonet / spot_132 / doc / btnc.doc / btnc.txt < prev    next >
Text File  |  1996-10-06  |  11KB  |  397 lines
  1.  
  2.                              BTNC v2.00 4D
  3.  
  4.                      BinkleyTerm/ST Nodelist Compiler
  5.  
  6.  
  7.                              by Daniel Roesen
  8.  
  9.                            FidoNet  2:2454/95.2
  10.                            NeST     90:400/602
  11.  
  12.  
  13.  
  14.                            and  Olivier Booklage
  15.  
  16.                            FidoNet  2:320/107.10
  17.                            AtariNet 51:901/1.10
  18.                            NeST     90:800/1.10
  19.  
  20.  
  21. *********************************************************************
  22.  
  23. What's all this about?
  24. ======================
  25.  
  26. After many times feeling angry about the version 6 nodelist format (3D),
  27. the slow processing by ParseList and the thousands of utilitys needed for
  28. running a multi-domain system and the 24000 pointlist, I decided to write
  29. a new nodelist processor. The result is BTNC.
  30.  
  31. The advantages of BTNC:
  32.  
  33. - Full 5D nodelist
  34. - VERY fast
  35. - only 3 files for the output nodelist, no matter how many domains you use
  36. - no need for PR24USER.TTP anymore
  37. - nearly all nodelist flags are parsed
  38. - all sysops are now included in one file (FIDOUSER.LST)
  39. - able to include FrontDoor-style pointlists
  40.   (see example 95point.pvt)
  41.  
  42.  
  43. Notes
  44. =====
  45.  
  46. The dial translation must be done by BinkleyTerm/ST with the 'Dial' table.
  47. This saves much time when processing the nodelist.
  48.  
  49. To use the BTNC nodelist (also refered as 'BNL format nodelist') should be
  50. used by BinkleyTerm/ST, you must set 'BTNC' in BINKLEY.CFG
  51.  
  52.  
  53. The Configuration File
  54. ======================
  55.  
  56. Before running BTNC.TOS you must edit NODELIST.CFG for your own
  57. requirements. Following a list of all statements in the configuration file:
  58.  
  59.  
  60. Domain  <name> <listfile> [<zone>]
  61. ----------------------------------
  62.  
  63. Designates domains to be compiled. <name> is the name of the domain,
  64. i.e. fidonet.org for FidoNet or nest.ftn for NeST. See BinkleyTerm/ST
  65. manual. <listfile> is the filename without extension of the nodelist
  66. file for this domain. If <zone> is specified, only zone <zone> is
  67. included in the output files.
  68.  
  69.  
  70. Pointlist  <listfile> <bossaddr>
  71. --------------------------------
  72.  
  73. Adds a FrontDoor format pointlist to <bossaddr>. <listfile> is the
  74. complete filename of the list. An example is included as 95POINT.PVT,
  75. the pointlist of my boss.
  76.  
  77. Example:  Pointlist   95point.pvt  2:243/95
  78.  
  79.  
  80. Addlist <listfile> <zone>:<region>
  81. ----------------------------------
  82.  
  83. Adds a 3D pointlist like POINTS24 or N_POINTS.GER to zone
  84. <tozone> and region <region>.
  85.  
  86. Example:  Addlist     points24.*   2:24
  87.  
  88.  
  89. MakeUserlist
  90. ------------
  91.  
  92. Tells BTNC to create a userlist of all systems processed called
  93. FIDOUSER.LST. Points (also from POINTS24 list) are included in this
  94. list, too.
  95.  
  96. Statistics
  97. ----------
  98.  
  99. Lets BTNC show a statistic about the createt output nodelist.
  100.  
  101. Display
  102. -------
  103.  
  104. Switches screen outputs on. If turned off (default), BTNC is a little
  105. bit faster.
  106.  
  107.  
  108. Troubleshooting
  109. ===============
  110.  
  111. If you have problems using BTNC, feel free to contact me at the addresses
  112. mentioned at the top of this text.
  113.  
  114.  
  115. Program status
  116. ==============
  117.  
  118. This program is freeware. You are allowed to copy it to others and make
  119. the complete archive available on BBS systems. Selling this program or
  120. distributing it on public domain disks is NOT allowed.
  121.  
  122.  
  123.  
  124.  
  125. Update to version 1.40
  126. ======================
  127.  
  128. - More checking for illegal lines in the raw nodelists.
  129. - Down nodes are also written into the compiled nodelist.
  130. - Bug fixed which causes wrong entries in the compiled nodelist for
  131.   independent nodes in a region when using the AddList statement for
  132.   this region.
  133.  
  134. Update to version 1.50
  135. ======================
  136.  
  137. - Fixed parsing of german points24 list. The format of this list has
  138.   changed and caused funny entries written into fidouser.lst
  139.   
  140. Update to version 1.60
  141. ======================
  142.  
  143. - To avoid problems when compiling a new nodelist in multitasking 
  144.   environments (Semper may access NODEINFO.BNL) the nodelist was first
  145.   compiled into NODEINFO.TMP. After successfull compiling, NODEINFO.BNL
  146.   was replaced by NODEINFO.TMP. Attention: This requires temporarily the
  147.   harddisk space for two BNL files.
  148.   
  149. - Support for the Semper "ReRead NodelistIndex" message. The message was
  150.   send after renaming the NODEINFO.TMP to NODEINFO.BNL. In addition a file
  151.   called READNIDX.SYS was created in the Semper system directory.
  152.  
  153. - Support for the following nodelist flags added:
  154.   H14, H16, ZYX, Z19, V32T, V34, VFC, ISDNA, ISDNB and ISDNC. Maybe future
  155.   versions of Semper include special dial translations according to the
  156.   nodelist flags.
  157.  
  158. Update to version 1.70
  159. ======================
  160.  
  161. - No implicit addition of nodelist flags. Former versions of BTNC automatically
  162.   adds for example V32B,V32 if the ZYX flag was set.
  163.  
  164. Update to version 1.80
  165. ======================
  166.  
  167. - Flags like U,V32T,ISDNA were not recognized properly.
  168. - Unpublished phone numbers of private nodes are now replaced by the nearest
  169.   Hub, Host number. Attention: In the case that you've defined a password 
  170.   protected session with the called Hub, Host of the private node, your 
  171.   system will recieve a password error.
  172.   
  173.   This feature is necessary if your mailprocessor doesn't route crashmails
  174.   to private nodes automatically to their hub. 
  175.   
  176. Update to version 1.86
  177. ======================
  178.  
  179. - Parsing of new ISDN nodelist flags X75, V110L and V110H implemented
  180.  
  181. Update to version 2.00 4D
  182. =========================
  183.  
  184. Many thanks to Olivier for implementing parsing of 4D style nodelists.
  185. Please read the following text carefully.
  186.  
  187. Why this version ?
  188. ==================
  189.  
  190.   We see that most of the PointLists produce right now are in 4D,
  191.   so those version of BTNC offers to compile that kind of Lists.
  192.  
  193.  
  194. Modifications done
  195. ==================
  196.  
  197.  
  198. 1/ Addlist 4D
  199.    ----------
  200.  
  201.   You just have to indicate inside the nodelist.cfg file that the
  202.   Addlist is in 4D putting a '4d' indication after the address.
  203.  
  204.  e.g. of nodelist.cfg :
  205.  
  206. Domain            fidonet.org    nodelist 2
  207. Addlist           plistr32.*     2:32     4d
  208. MakeUserlist
  209. Statistics
  210. Display
  211.  
  212.  
  213.   The 4D lists are defined like that :  
  214.  
  215. Region,32,France,F,Philippe_Feuerstein,33-75676164,9600,CM,XA,H16,V34,V32T,VFC
  216. Host,320,Net_Paris_Host_NEC,Paris,Evaldas_Auryla,33-1-45696431,9600,CM,XA,V32B,V42B,VFC
  217. Hub,100,Paris_East_Hub,Dammartin_en_Goele,Eric_Delord,33-1-45845623,9600,CM,XX,V34,H16,V32T,VFC
  218. ,107,320/107,Paris,Herve_Piedvache,33-1-42511135,9600,CM,XA,V32B,VFC
  219. Point,5,Power_With_Fun_:_Falcon_030,La_Baule_France,Philippe_Riguidel,-Unpublished-,9600,CM,XA,V34,V42B
  220. Point,7,The_Bazdash_Vool,Villecroze_France,Gilles_Picard,-Unpublished-,9600,CM,XA,V34,V42B
  221. Point,9,Delphine_Soft,Villeneuve_Saint_Georges_France,Fabrice_Rodet,-Unpublished-,9600,CM,XA,V34,V42B
  222. Point,10,Froggys_love_Atari_too_!,Boulogne_Billancourt_France,Olivier_Booklage,-Unpublished-,9600,CM,XA,V34,V42B
  223. Point,12,Arrakis_BBS,Evry_France,Arnaud_Pignard,-Unpublished-,-Unpublished-,9600,CM,XA,V34,V42B
  224. Point,14,Waiting_for_the_Milan...,Boulogne-Billancourt_France,Antoine_Calando,-Unpublished-,9600,CM,XA,V34,V42B
  225. Point,15,Point's_TheBBS,Meylan_France,Christian_Marillat,-Unpublished-,9600,CM,XA,V34,V42B
  226. Point,16,TheBBS_Point_That's_all_!,Fondettes_France,Christophe_Boyanique,-Unpublished-,9600,CM,XA,V34,V42B
  227. Hub,200,Paris_Sud_Ouest_HUB,Plaisir,Jean-Philippe_Luiggi,33-1-30555221,9600,CM,XA,V32B,V42B
  228.  
  229.  
  230.  Nota : 'Point' and 'Pvt' are accepted.
  231.  
  232.  
  233.  
  234. 2/ Addlist 3D New German format
  235.    ----------------------------
  236.  
  237.    The new German 3D PointList is defined as the POINTS24. file.
  238.    To use those lists you have to indicate 'Nf' like in this example :
  239.  
  240.  
  241. Domain            nest.ftn       nestlist
  242. Addlist           nestpr08.*     90:8     Nf
  243.  
  244.  
  245.  
  246.    
  247.  
  248. 3/ 'LogFile' Command
  249.    ------------------
  250.  
  251.    Everyone asked for it ... now you get it ... a LogFile command 
  252.    which offer to know what exactly have been done by BTNC inside a 
  253.    file.
  254.  
  255.    To use this function, this is an example file :  
  256.  
  257. Logfile           c:\btnc.log
  258. Domain            fidonet.org    nodelist 2
  259. Addlist           plistr32.*     2:32     4d
  260. MakeUserlist
  261. Statistics
  262. Display
  263.  
  264.  
  265.   So all the screen actions are saved inside the file called 
  266.   c:\btnc.log. The name of the file must be lower than 127 characters.
  267.  
  268.  
  269. 4/ Error sound advertisment
  270.    ------------------------
  271.  
  272.    When BTNC find a writing file error, for example when the file is 
  273.    full, you can hear during 10 sec an alarm to inform you about the 
  274.    problem, then BTNC is quit.
  275.  
  276.  
  277.  
  278. 5/ Error during reading
  279.    --------------------
  280.  
  281.    In this version of BTNC, and otherwise of the original version, 
  282.    now when BTNC get a mistake during reading file there is no bomb 
  283.    but an error message to inform you about the problem !
  284.  
  285.  
  286. Informations
  287. ============
  288.  
  289.  
  290.  Fidouser.lst :
  291.  ------------
  292.  
  293.   Only the privates points from a nodelist, the points from a new 
  294.   German 3D pointlist and from a 4D pointlist are added inside the 
  295.   fidouser.lst.
  296.  
  297.   The points from a classical 3D pointlist, are compiled but never 
  298.   appear inside this list.
  299.  
  300.  Nodelist.cfg :
  301.  ------------
  302.  
  303.    I have seen that BNTC do not like tabulations inside this file, so 
  304.    you must replace then by real space !
  305.  
  306.  
  307. Update
  308. ======
  309.  
  310.  
  311.   -V1.1
  312.          Now correctly compile Pvt from Nodelist
  313.  
  314.  
  315.   -V1.2
  316.  
  317.         The 4D detection is now done with a '4d' indication after the 
  318.         address ("Addlist  fichier.*  zone:region  4d").
  319.  
  320.         Stay compatible with the orginal version 1.86 of BTNC, known 
  321.         new German 3D PointList like POINTS24 or N_POINTS.GER.
  322.  
  323.  
  324.   -V1.3
  325.  
  326.        New command 'logfile' inside nodelist.cfg to know exactly what 
  327.        have been done by BTNC.
  328.  
  329.  
  330.   -V1.4
  331.  
  332.        Points from a 4D PointList are now added to the fidouser.lst 
  333.        file.
  334.  
  335.  
  336.   -V1.5
  337.  
  338.        Logile look is better now.
  339.  
  340.        Add verification during reading/writing with alarm and 
  341.        messages, but no bomb !
  342.  
  343.  
  344.   -V1.6
  345.  
  346.        Big bug from the original version corrected if none nodelist 
  347.        found !
  348.  
  349.  
  350.   -V1.7
  351.  
  352.        Bug corrected with user name in several parts inside the 
  353.        fidouser.lst.
  354.  
  355.        E.g.: Win_Van_Sebroeck (2:292/875) :
  356.       'Van, Win  2:292/875', will be 'Van Sebroeck, Win  2:292/875'
  357.  
  358.  
  359.   -V1.8
  360.  
  361.        First official version sent to the author Daniel Roesen in 
  362.        waiting for approbation of BNTC 4D :)
  363.  
  364.  
  365.  
  366. Beta-Tests have been done by :
  367. ==============================
  368.  
  369.         Herv‚ Piedvache     2:320/107@fidonet.org
  370.         Pascal Ricard       2:320/107.26@fidonet.org
  371.         Dorian Darcourt     2:320/107.9@fidonet.org
  372.  
  373. Thanks to them !
  374.  
  375.  
  376.  
  377.  
  378. Bugs :
  379. ====
  380.  
  381.  
  382.       The 'Logfile' command must be put at the beginning of the 
  383.       nodelist.cfg file.
  384.  
  385.  
  386. If you find other things or if you have any ideas for getting BTNC 
  387. better, just write me :
  388.  
  389. Olivier Booklage
  390.  
  391. FidoNet  2:320/107.10
  392. AtariNet 51:901/1.10
  393. NeST     90:800/1.10
  394.  
  395.  
  396.  
  397.